home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / rfw_v120.zip / RFWDOCEN.DOC < prev    next >
Text File  |  1993-02-08  |  82KB  |  1,535 lines
  1. ╔══════════════════════════════            ┌─────────────────┐
  2. ║ RFC/W     Remote Access                  │    D.I.S.P.     │────┐
  3. ║           Windowed file-list             │                 │░░░░│
  4. ╟──────────────────────────────            │                 │░░░░│
  5. ║ (c) 1993  Robert W.van Hoeven            │ Dutch           │░░░░│
  6. ╟──────────────────────────────            │   Independent   │░░░░│
  7. ║ Release : 1.20                           │     ShareWare   │░░░░│
  8. ║ Rel.Date: 8th February 1993              │       Programmer│░░░░│
  9. ╠══════════════════════════════            └─────────────────┘░░░░│
  10. ║                                          |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ RFC.EXE / RFCCFG.EXE                   |    └─────────────────┘
  12. ║ │ RFW.EXE / RFWCFG.EXE                   |       ┌─────┐        |
  13. ║ │                                        |       │░░░░░│        |
  14. ║ │                                        |       └──┬──┘        |
  15. ║ │ Lines starting with '│' are            |     ┌────┴────┐      |
  16. ║ │ changes from version 1.16 !            ------││││││ ═══│-------
  17. ║                                                └─────────┘
  18. ╠═══════════════════════════════
  19. ║ Address: Robert W. van Hoeven
  20. ║          PO. Box 131
  21. ║          1170 AC  Badhoevedorp
  22. ║          Nederland / Holland
  23. ╚═══════════════════════════════
  24.  
  25.  ┌───────┬─────────────────────────────────────────────────────────────┐
  26.  │   0   │ Table of contents                                           │
  27.  └───────┴─────────────────────────────────────────────────────────────┘
  28.  
  29.  1 ----    General information
  30.   1.1      Copyrights and License Agreement
  31.   1.2      Newer versions and contacting the author
  32.  
  33.  2 ----    Package description and requirements
  34.   2.1      Preface
  35.   2.2      Requirements
  36.   2.3      Included files
  37.   2.4      History
  38.   2.5      Multi-taskers
  39.  
  40.  3 ----    Installation description
  41.   3.1      Installation
  42.   3.2      Install RFC
  43.   3.3      Install RFW
  44.   3.4      BBS menu options
  45.  
  46.  4 ----    Runtime information
  47.   4.1      Calling RFW
  48.   4.2      FileDoor/DISP-compatible tag-file <tm>
  49.  
  50.  5 ----    Version information and credits
  51.   5.1      The BETA-team
  52.   5.2      Credits
  53.   5.3      Version history
  54.   5.4      Copyright, Trademarks
  55.  
  56.  ┌───────┬─────────────────────────────────────────────────────────────┐
  57.  │   1   │ General information                                         │
  58.  └───────┴─────────────────────────────────────────────────────────────┘
  59.  
  60.  1.1 Copyrights and License Agreement
  61.  ────────────────────────────────────
  62.  
  63.  - Users of the RFW-package must accept this disclaimer of warranty:
  64.  
  65.  - The  RFW-package  is  supplied  as  is.   The  author  disclaims  all
  66.    warranties, expressed or implied, including, without limitation,  the
  67.    warranties of merchantability  and of fitness  for any purpose.   The
  68.    author assumes  no liability  for damages,  direct or  consequential,
  69.    which may result from the use of the RFW-package;
  70.  
  71.  - The  RFW-package  is  a  "shareware  program"  and is provided at  no
  72.    charge to the user for evaluation.   Feel free to share it with  your
  73.    friends,  but  please  do  not  give  it  away  altered or as part of
  74.    another  system.   The  essence  of  "user-supported"  software is to
  75.    provide personal  computer users  with quality  software without high
  76.    prices, and yet to provide  incentive for programmers to continue  to
  77.    develop new products.
  78.  
  79.  - If  you find  this program  useful and  find that  you are  using and
  80.    continue the  use of  the RFW-package  after a  30 days trial period,
  81.    you must register the RFW-package as described below;
  82.  
  83.  - Non-commercial can get a license for the usage up to this release  of
  84.    the RFW-package for  a small amount  of money. Look  into the details
  85.    in  REGISTER.RFW.  Previous  registered  users  will  receive  a  big
  86.    reduction to upgrade to the  newer versions. These users should  look
  87.    into the details in UPGRADE.RFW.   For Non-commercial users there  is
  88.    a POSSIBILITY to submit to one of the special contracts as  explained
  89.    in the file REGISTER.RFW.
  90.  
  91.  - Commercial usage of  RFW will cost somewhat  more. Also, a so  called
  92.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  93.    direct to the  SysOp to get  full access) is  has to pay  more than a
  94.    Non-commercial  user.  Both  types  of  users  should  look  into the
  95.    details in REGISTER.RFW;
  96.  
  97.  - The registration of the RFW-package will license ONE copy for use  on
  98.    any computer at any  one time, as long  as the usage confirms  to the
  99.    type of registration you have done (so NON-commercial usage when  you
  100.    have a non-commercial license);
  101.  
  102.  - Anyone  distributing  the  RFW-package  for any kind of remuneration
  103.    must  first   contact  the   Author   at   the  address   above   for
  104.    authorization.
  105.  
  106.  - You are  encouraged  to  pass a copy   of the RFW-package  along   to
  107.    your friends  for  evaluation.   Please  encourage  them to  register
  108.    their copy if they find that they can use it;
  109.  
  110.  - Support  on  RFW,  when  used  in  a  non-commercial environment,  is
  111.    available  by  means  of  written  letters  or by entering the inter-
  112.    national echomail area DISP;
  113.  
  114.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  115.    conference <tm> called DISP (international). Entering this echo  does
  116.    not  exclude  you  of  the  duty  to register the RFW-package, though
  117.    users who evaluate the product can enter the echo for questions;
  118.  
  119.  - The  RFW-package, all  programs, the  documentation and support-files
  120.    is  copyrighted  1990,92  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  121.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  122.    this  package  for  backup  purposes.  Also  you  may  copy and share
  123.    unmodified copies of the whole package, providing that the  copyright
  124.    notice    is    reproduced    and    included    on    all    copies.
  125.    Excluded from this statement  are the support-files written  by other
  126.    authors.  Please  refer  to  the  documentation of these programs for
  127.    copyrights and license agreements;
  128.  
  129.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  130.    decompile  and/or  disassemble  the  software  in  the   RFW-package.
  131.    Patching the medium at  places that carry the  software is seen as  a
  132.    program change and is also forbidden. It is forbidden to create a  so
  133.    called 'bypass' to skip the original introduction screens and  delay.
  134.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  135.    author (Robert W. van Hoeven) himself;
  136.  
  137.  - Performing  any  of  the  illegal  actions as stated in the previous
  138.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  139.    important, to the registered users;
  140.  
  141.  - Bulletin Board  Systems that distribute  the RFW package  can convert
  142.    the WHOLE package  to any archive-system  they like but  all original
  143.    files must  be included  in the  new archive.  The RFW-package on the
  144.    Bulletin Board  can contain  at the  most 2  extra files. These files
  145.    can only be  a commercial for  that Bulletin Board  and/or validation
  146.    data that is presented  as a service to  all users and shall  have no
  147.    other functions;
  148.  
  149.  - After  the normal  trial period  of 30  days, you  must register  the
  150.    soft- ware (see REGISTER.RFW) or you must remove it from your PC;
  151.  
  152.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  153.    answered as soon I have the time  to do so. You can send me  a letter
  154.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  155.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  156.    Reinier de Groot).  When you want to send me normal mail, address  it
  157.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  158.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  159.    Echomail <tm> area;
  160.  
  161.  
  162.  1.2 Newer versions and contacting the author
  163.  ───────────────────────────────────────────────────────────────────────
  164.  The newest version of  RFW is always available  at the DISP-HQ on  node
  165.  2:512/100.  RFW  is  also  distributed  thru  a  number of DISP support
  166.  nodes.  There are three ways of obtaining newer versions of RFW:
  167.  
  168.  
  169.  - Logging on at DISP-HQ or a support node
  170.    Look into the file SUPPORT.RFW for a full list of support nodes;
  171.  
  172.  - Logging on to a SDS node
  173.    RFW is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  174.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  175.    distribution point in Holland;
  176.  
  177.  - Logging on to your own BBS;
  178.    Chances  are,  that  you  will  find  an older version (international
  179.    users) because it will take some time for the new version to  'bleed'
  180.    thru the net;
  181.  
  182.  - Update service;
  183.    You can enter a special update service (read REGISTER.RFW).
  184.  
  185.  
  186.  If you think you have found problems in RFW, or in any other case,  you
  187.  wish to contact the author, you can send me:
  188.  
  189.  - A letter to the address you can find in the header of this file;
  190.  
  191.  -  A  NetMail  <tm>  message  to  Rob Van.hoeven (please mind the point
  192.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  193.  
  194.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  195.  
  196.  
  197.  ┌───────┬─────────────────────────────────────────────────────────────┐
  198.  │   2   │ Package description and requirements                        │
  199.  └───────┴─────────────────────────────────────────────────────────────┘
  200.  
  201.  2.1 Preface
  202.  ────────────────────────────────────────────────────────────────────────
  203.  This program,  dating from  the 1990's,  was the  followup of the first
  204.  try to create a windowed file-lister with tag capabilities. It was  the
  205.  first  program  for  RA/QBBS/SBBS  alike  BBS-programs  that  contained
  206.  windowed  list  functions  and  the  option  to  tag  files  for  later
  207.  reference  from  other  programs  !  Currently,  the combination of RFW
  208.  <tm>,  MTS  <tm>  and  FileDoor  <tm>  can  replace  almost  all   your
  209.  file-access in  your bulletin-board  and these  three programs  can all
  210.  work with the tag-file (DISP/FileDoor compatible tag-file <tm>),  which
  211.  can be created by RFW.
  212.  
  213.  After RFW (and its older brother  QFF) was released, a number of  other
  214.  clones hit the  market, but RFW  has still a  major share, though  some
  215.  other listers tried (successfully)  to gain on speed  or possibilities.
  216.  In my opinion, it  is not the speed  but the added options  in RFW that
  217.  still make it  a nice program  to use (and  it is still  free of charge
  218.  when used in a non-commercial environment).
  219.  
  220.  Also a point to remember is,  that most BBS systems now also  support a
  221.  kind of tagging. Some of them  do this in a compatible way,  being able
  222.  to create a  DISP/FileDoor compatible tag-file.  In this case  the user
  223.  still  has  the  option  to  use  one  or  more  products  from the BBS
  224.  internally, but replace one  or more by doors.  From the point of  view
  225.  of the Sysop (and user) this  is very thoughtful of the authors  of the
  226.  BBS.  To  reverse  the  matter,  those  BBS  programs  that  create  an
  227.  interface of their own (with their own, non compatible, tag-files)  are
  228.  less flexible. It comes to mind  that these authors are trying to  keep
  229.  out some  of the  good door  products that  have been  created by  many
  230.  people over the last years.
  231.  
  232.  Currently I am working  on RFW 2.01 which  will contain a complete  new
  233.  user-interface, making  it almost  look the  same as  a database browse
  234.  program. The 2.01 version of RWF will take some months though,  because
  235.  a number of  routines must be  rewritten to make  it both flexible  AND
  236.  fast. In the  meanwhile, this in-between  release of RFW  (with the old
  237.  interface) is  released, to  grant a  number of  much asked suggestions
  238.  and to fix a number of bugs (most of them were cosmetic bugs).
  239.  
  240.  
  241.  2.2 Requirements
  242.  ────────────────────────────────────────────────────────────────────────
  243.  RFW requires:      - PC XT/AT/386/486
  244.                     - At least 160K free memory;
  245.                     - DOS 3.xx and higher;
  246.                       (tested with 4Dos 4.01, should work with lower
  247.                       versions);
  248.                     - HDU optional
  249.                     - A Bulletin Board System. Directly supported are
  250.                       the QuickBBS, SuperBBS and Remote Access types;
  251.  
  252.  
  253.  2.3 Included files
  254.  ────────────────────────────────────────────────────────────────────────
  255.  The package includes : RFW.EXE        The main lister program
  256.                         RFWCFG.EXE     Configuration program for RFW
  257.                         RFC.EXE        The main compiler program
  258.                         RFWCFG.EXE     Configuration program for RFC
  259.                         RFWHLP.ANS     Example help-file for ANSI users
  260.                         RFWHLP.ASC     Example help-file for ASCII users
  261.  
  262.  
  263.  2.4 History
  264.  ────────────────────────────────────────────────────────────────────────
  265.  RFW came as an extended followup  of the QFF program, which comes  with
  266.  the  'Quick  File  Vacuumcleaner'  <tm>  package (called QFV). This QFV
  267.  package is very large and the QFF  program is only a small part of  the
  268.  package  (which  main  objective  is  to  automate file-management on a
  269.  BBS).
  270.  
  271.  QFF will also be enhanced in a  later stage. When both RFW and QFF  are
  272.  enhanced (end '92), they will both  use the same types of databases  to
  273.  scroll thru the files in a VERY fast way and users can choose the  type
  274.  of interface they like most  (either RWF or QFF), though  both programs
  275.  go from a different  point of view (RFW  is windowed, QFF is  a page by
  276.  page viewer).
  277.  
  278.  In the years, QFV/QFC/QFF on one side and FileDoor, MTS and RFW on  the
  279.  other side have created a sort  of standard for extra comment lines  in
  280.  the FILES.BBS  (starting with  a '+'  character). This  release of  RFW
  281.  maintains that  standard. Also  lines in  FILES.BBS that  are up to 255
  282.  bytes in  length ARE  observed by  RFW. If  one should  come up  with a
  283.  better  idea,  let  me  know.  Most  important products (like file-area
  284.  managers) can now handle these +-comment lines.
  285.  
  286.  
  287.  2.5 Multi-taskers
  288.  ────────────────────────────────────────────────────────────────────────
  289.  RFW is aware of multi-taskers. When  SHARE is loaded (and even when  it
  290.  isn't), RFW will  share the pre-compiled  database with other  (concur-
  291.  rent)  RFW  tasks.  RFC  (the  compiler)  will  use  the database on an
  292.  exclusive  basis,  so  you  need  to  run  the compiler somewhere in an
  293.  event.
  294.  
  295.  ┌───────┬─────────────────────────────────────────────────────────────┐
  296.  │   3   │ Installation description                                    │
  297.  └───────┴─────────────────────────────────────────────────────────────┘
  298.  
  299.  3.1 Installation
  300.  ────────────────────────────────────────────────────────────────────────
  301.  Installation  is  made  simple.  You  must  use  the  two configuration
  302.  programs to  make patched  versions of  the original  programs. You can
  303.  use the  CFG-programs to  alter the  current version  without having to
  304.  install options again and you can  use the main programs to type-out  a
  305.  new configuration which can be imported into newer versions.
  306.  
  307.  First time installation is as follows:
  308.  
  309.  - Put RFC.EXE somewhere on your hard-disk;
  310.  
  311.  - Put RFCCFG.EXE in the same directory;
  312.  
  313.  - Change to this directory and run RFCCFG (see below);
  314.  
  315.  - Put RFW.EXE somewhere on your hard-disk;
  316.  
  317.  - Put the RFWHLP.??? files  somewhere on you harddisk, on  the DOS-path
  318.    or along with  RFW.EXE in the  same directory (access  depends on the
  319.    installation of RFW0;
  320.  
  321.  - Put RFWCFG.EXE in the same directory;
  322.  
  323.  - Change to this directory and run RFWCFG (see below);
  324.  
  325.  - Add  RFC.EXE somewhere  in your  batch file  that runs  your BBS  (an
  326.    event) and/or behind the program that you use to alter the  FILES.BBS
  327.    files;
  328.  
  329. │- Before you  start  running  RFC in your even, you should at least run
  330. │  RFC once with the /ALL option added on the command-line;
  331.  
  332.  - For  fastest access  you can  put the  compiled files  somewhere on a
  333.    RAM-disk, but  make sure  you created  these files  first on  a fixed
  334.    disk;
  335.  
  336.  - Put RFW.EXE in a type 7  at locations where you want to replace  your
  337.    current files-list  with this  program (so  at files-list, new-files,
  338.    keyword-search and file-search) as described be- low;
  339.  
  340.  Upleveling to THIS release (1.20) goes as follows:
  341.  
  342.  - Swap to the directory that contains the old RFW.EXE and RFC.EXE;
  343.  
  344.  - Run the OLD RFW.EXE with the /CFG command-line option;
  345.  
  346.  - Do the same with RFC.EXE;
  347.  
  348.  - Replace   the   RFC.EXE,   RFCCFG.EXE,   RFW.EXE and  RFWCFG.EXE with
  349.    the newer versions;
  350.  
  351.  - Run  RFCCFG.EXE  and  import  the old configuration-file, then  alter
  352.    the fields where needed;
  353.  
  354.  - Run  RFWCFG.EXE  and  import  the old configuration-file, then  alter
  355.    the fields where needed;
  356.  
  357. │- Run  RFC.EXE  with  the  /ALL  switch once, because the format of the
  358. │  database has been changed between 1.16 and 1.20 !
  359.  
  360.  RFC.EXE makes two files (a  compiled file-list and area-list). RFC  can
  361.  (optionally)  create  temporary  files  first  and when ready, RFC will
  362.  move these files  over the old  version. In this  case you can  run RFC
  363.  almost  any  time,  even  when  the  BBS  if  active  and users use the
  364.  file-list.
  365.  
  366.  RFC will  take the  area-file and  compiles a  list with  records to be
  367.  displayed later. All extra info (like security level, area name,  flags
  368.  and so on) is imported  into the compiled list. Also  CD-ROM (alternate
  369. │files area's)  are  supported  in RA 1.xx, RA 0.xx and SBBS 1.16+ mode.
  370. │RFW has explicit support for the new RA 1.20 format. This release of RA
  371. │is still  in  beta-test  and the support for this version *can* well be
  372. │incorrect when another change in the RA-structs is implemented.
  373.  
  374.  When installing for the first time,  you must run RFC from the  command
  375.  line first to get a database. Later,  in the event, a new list will  be
  376.  created from inside the batch-file or after you have altered the  files
  377. │in FILES.BBS. When you run RFC for the first time, use the /ALL command
  378. │line option !
  379.  
  380.  RFW takes the compiled lists  and creates a sub-list (depending  on the
  381.  task-number) in memory,  EMS, XMS or  disk, depending on  the resources
  382.  and  the  length  of  the  list.  The  creation of a sub-list is needed
  383.  because only  at execution-time  of RFW,  RFW knows  the security level
  384.  and flags (and chosen option for that matter) and creates the  sub-list
  385.  with this  information. BUT  only the  compiled list  is accessed  on a
  386.  very fast speed and not all  individual files. It should be clear  that
  387.  RFW.EXE points  to the  same compiled  files that  RFC.EXE has created.
  388.  Also ensure that the files are compiled, at least, every day  otherwise
  389.  your users won't see new files for a long, long time.
  390.  
  391.  
  392.  3.2 Install RFC
  393.  ────────────────────────────────────────────────────────────────────────
  394.  Both RFC and RFW have to be installed first, because it is almost  sure
  395.  that  you  can  not  use  the  supplied  defaults  (except the colors).
  396.  Better, when RFC  and RFW are  not installed at  least once, they  will
  397.  abort !
  398.  
  399.  When you start RFCCFG.EXE, you will get the following questions:
  400.  
  401.  ╒══════════════════════════════════════════════════════════════════════════════╕
  402.  │ You can now select the type of BBS you run RFC on. Currently there           │
  403.  │ are four types supported, QuickBBS <tm>, Remote Access 0.xx /1.xx            │
  404.  │ and SBBS.                                                                    │
  405.  │ NOTE : Use <ESC> to abort installation and read documentation !!             │
  406.  │                                                                              │
  407.  │ You can enter the following types:  1 - QuickBBS <tm>      Rel 2.74-         │
  408.  │                                     2 - Remote Access <tm> Rel 0.xx          │
  409.  │                                     3 - Remote Access <tm> Rel 1.0x          │
  410.  │                                     4 - SBBS <tm>          Rel 1.16+         │
  411.  │                                     5 - QuickBBS <tm>      Rel 2.75+         │
  412.  │                                     6 - Remote Access <tm> Rel 1.1x+         │
  413. ││                                     7 - Remote Access <tm> Rel 1.2x+         │
  414. ││                                     8 - Maximus <tm>       Rel 2.xx          │
  415.  │                                                                              │
  416.  │ Type of BBS RFC will assume                      : 6                         │
  417.  ╘══════════════════════════════════════════════════════════════════════════════╛
  418.  RFC needs to know the type of BBS you are running. This information  is
  419.  needed to  read the  proper area-file  and it's  layout. For the Remote
  420.  Access flavors, point to the  FILES.RA file. For the old  QuickBBS type
  421.  you  should  point  to  FLSEARCH.CTL  and  the new QuickBBS type should
  422.  point to the FILEAREA.DAT file.  The SuperBBS type should point  to its
  423. │own file (FLSEARCH.BBS, not CTL). The MAXIMUS <tm>  support  is not yet
  424. │implemented in RFC, so  this  option  can not be selected. When you run
  425. │the RA 1.20  beta  release (A or B), you  should  try to use RA 1.2x on
  426. │RFC but try  RFW  with  both  1.1x or 1.2x  versions. RFC needs the new
  427. │FILES.RA structure but  your RA-beta could well use the OLD 1.1x format
  428. │for EXITINFO.BBS (this is why you need to install RFW with 1.1x). Newer
  429. │RA-beta versions *could* use the new EXITINFO.BBS format and RFW should
  430. │be installed with explicit 1.20 support.
  431.  
  432.  ╒══════════════════════════════════════════════════════════════════════════════╕
  433.  │ Drive, path and name for area-file to use        : D:\BBS\RAX\FILES.RA       │
  434.  ╘══════════════════════════════════════════════════════════════════════════════╛
  435.  This field must point to (one  of your) area-files. RFC will take  this
  436.  file to  create the  compiled list.  See the  description above  to see
  437.  which file is needed for what type of BBS.
  438.  
  439.  ╒══════════════════════════════════════════════════════════════════════════════╕
  440.  │ Drive, path to alternate FILES.x files (CD-ROM)  : D:\BBS\RAX\FIL\           │
  441.  ╘══════════════════════════════════════════════════════════════════════════════╛
  442.  This question will only  be asked when you  use a RA 1.xx  (and higher)
  443.  type of BBS (not  for RA 0.xx). This  directory must point to  the same
  444.  directory  you  have  installed  with  RACONFIG  and that points to the
  445.  directory where  alternate FILES.n  (where n  is the  file-area number)
  446.  are stored;
  447.  
  448.  ╒══════════════════════════════════════════════════════════════════════════════╕
  449.  │ Drive, path and name for compiled file      (CMP): D:\BBS\RAX\RFC.CMP        │
  450.  ╘══════════════════════════════════════════════════════════════════════════════╛
  451.  This  field  must  contain  the  name  of the compiled files-list. This
  452.  field must  point to  the same  file as  supplied in  RFW.EXE. You must
  453.  supply  the  full  drive,  path  and  name  otherwise  RFCCFG.EXE  will
  454.  complain.
  455.  
  456.  ╒══════════════════════════════════════════════════════════════════════════════╕
  457.  │ Drive, path and name for compiled area-file (ARE): D:\BBS\RAX\RFC.ARE        │
  458.  ╘══════════════════════════════════════════════════════════════════════════════╛
  459.  This field must contain the name of the compiled area-list. This  field
  460.  must point to  the same file  as supplied in  RFW.EXE. You must  supply
  461.  the full drive, path and name otherwise RFCCFG.EXE will complain.
  462.  
  463. │╒══════════════════════════════════════════════════════════════════════════════╕
  464. ││ Directory for temporary files                    : G:\ZIP                    │
  465. │╘══════════════════════════════════════════════════════════════════════════════╛
  466. │This  field  must  point to a drive and directory that will contain the
  467. │temporary  files that RFC can create. In this directory, RFC will store
  468. │the CD-ROM  area's  overhere (see chapter on CD-ROM) when a new file is
  469. │compiled !  Depending  upon  the  number of CD-ROM area's you have, the
  470. │drive  must  have from 0 to the size of the current compiled file bytes
  471. │free.
  472. │
  473. │╒══════════════════════════════════════════════════════════════════════════════╕
  474. ││ Drive, dir and name of the FILES.CTL or empty    : D:\BBS\RAX\FILES.CTL      │
  475. │╘══════════════════════════════════════════════════════════════════════════════╛
  476. │This field  must  point to a drive, directory and name of the FILES.CTL
  477. │file  (if you have any). If  there isn't such a file available, you can
  478. │leave the field empty. When the FILES.CTL will always be in the current
  479. │directory at the moment RFC starts, you can leave out the directory and
  480. │the drive. Both RA, QBBS and SBBS formats of the FILES.CTL are allowed.
  481. │RFC will  use the  information from this file to detect which files are
  482. │free-files and which contain a password. RFW can display this info when
  483. │it displays a file-list.
  484. │
  485. │╒══════════════════════════════════════════════════════════════════════════════╕
  486. ││ Enable keyword search INSIDE files        [Y/N]  : Y                         │
  487. │╘══════════════════════════════════════════════════════════════════════════════╛
  488. │RFW can search  for keywords inside non-archived files (like text files
  489. │on your BBS). When  you  allow  this  option (see RFWCFG.EXE), you must
  490. │also instruct  RFC to do something extra. When you allow this option in
  491. │RFCCFG.EXE (so  RFC  will do "its's thing") you can also set the option
  492. │in  RFWCFG.EXE. When  you don't set the option in RFCCFG, you can still
  493. │set  the  option  in RFWCFG but RFW will NEVER look inside non-archived
  494. │files.
  495. │
  496. │This  option is configurable because RFC will mark those files that are
  497. │non-archive  files. To  do so, RFC will have to open each file while it
  498. │compiles the  database. This will cost extra time and will be of little
  499. │use when  you  don't  have  much text-files and/or you won't allow your
  500. │users to search inside these text-files.
  501. │
  502. │╒══════════════════════════════════════════════════════════════════════════════╕
  503. ││ Starting character of FILES-counter [empty=none] : [                         │
  504. ││ Ending   character of FILES-counter [empty=none] : ]                         │
  505. │╘══════════════════════════════════════════════════════════════════════════════╛
  506. │Normally your  FILES.BBS  files  will  contain files-counters and these
  507. │will  start with the '[' character and end with the ']' character, like
  508. │[001] or  [1]. If  you don't use any files-counter, you can leave these
  509. │fields empty. When  you  use  OTHER  characters  (like '{' and '}') you
  510. │must supply  them overhere. RFC  will  use  this  information so it can
  511. │adjust your comments AFTER the counter (nicer look).
  512.  
  513.  ╒══════════════════════════════════════════════════════════════════════════════╕
  514.  │ Use original files only a short moment    [Y/N]  : Y                         │
  515.  ╘══════════════════════════════════════════════════════════════════════════════╛
  516.  If you supply a 'Y', RFC will compile $$$RC$$$.CMP and $$$RC$$$.ARE  in
  517.  the current  directory first  and after  compilation is  ready, it will
  518.  delete the original files and move  these files to the right place  and
  519.  with the right name. Make sure you have enough space on your  hard-disk
  520.  because  you  need  the  full  amount  of  space  the  compiled   files
  521.  use,twice.
  522.  
  523.  
  524.  3.3 Install RFW
  525.  ────────────────────────────────────────────────────────────────────────
  526.  When you start RFWCFG.EXE, you will get the following questions:
  527.  
  528.  ╒══════════════════════════════════════════════════════════════════════════════╕
  529.  │ You can now select the type of BBS you run RFW on. Currently there           │
  530.  │ are four types supported, QuickBBS <tm>, Remote Access 0.xx /1.xx            │
  531.  │ and SBBS.                                                                    │
  532.  │ NOTE : Use <ESC> to abort installation and read documentation !!             │
  533.  │                                                                              │
  534.  │ You can enter the following types:  1 - QuickBBS <tm>      Rel 2.74-         │
  535.  │                                     2 - Remote Access <tm> Rel 0.xx          │
  536.  │                                     3 - Remote Access <tm> Rel 1.0x          │
  537.  │                                     4 - SBBS <tm>          Rel 1.16+         │
  538.  │                                     5 - QuickBBS <tm>      Rel 2.75+         │
  539.  │                                     6 - Remote Access <tm> Rel 1.1x+         │
  540. ││                                     7 - Remote Access <tm> Rel 1.2x+         │
  541. ││                                     6 - Maximus <tm>       Rel 2.xx          │
  542.  │                                                                              │
  543.  │ Type of BBS RFW will assume                      : 6                         │
  544.  ╘══════════════════════════════════════════════════════════════════════════════╛
  545.  The same question as with RFCCFG.EXE. Look into the previous chapter !
  546.  
  547.  ╒══════════════════════════════════════════════════════════════════════════════╕
  548.  │ Drive, path and name for compiled file      (CMP): D:\BBS\RAX\RFC.CMP        │
  549.  ╘══════════════════════════════════════════════════════════════════════════════╛
  550.  Must be the same name as you supplied in RFCCFG.EXE.
  551.  
  552.  ╒══════════════════════════════════════════════════════════════════════════════╕
  553.  │ Drive, path and name for compiled area-file (ARE): D:\BBS\RAX\RFC.ARE        │
  554.  ╘══════════════════════════════════════════════════════════════════════════════╛
  555.  Must be the same name as you supplied in RFCCFG.EXE.
  556.  
  557.  ╒══════════════════════════════════════════════════════════════════════════════╕
  558.  │ Drive, path and name for ANS help-file or EMPTY  :                           │
  559.  ╘══════════════════════════════════════════════════════════════════════════════╛
  560.  You must use your  own HELP-files. This option  must point to the  name
  561.  location of  the help-file  for ANSI-users.  If you  leave this  option
  562.  empty, RFW  will search  for RFWHLP.ANS  (or RFWHLP.ASC)  in one of the
  563.  following locations:
  564.  
  565.  - Current directory;
  566.  - Directory where RFW.EXE is stored;
  567.  - Dos-path;
  568.  
  569.  If an ANS-file is not present, RFW will try to search for an ASC-file.
  570.  
  571.  ╒══════════════════════════════════════════════════════════════════════════════╕
  572.  │ Drive, path and name for ASC help-file or EMPTY  :                           │
  573.  ╘══════════════════════════════════════════════════════════════════════════════╛
  574.  See previous question.
  575.  
  576.  ╒══════════════════════════════════════════════════════════════════════════════╕
  577.  │ Location of tag-file, *CUR-current dir or EMPTY  : D:\BBS\RAX                │
  578.  ╘══════════════════════════════════════════════════════════════════════════════╛
  579.  With the release of FileDoor <tm>  a new type of file is  introduced to
  580.  support  the  tag-function  of  FileDoor. This FileDoor/DISP-compatible
  581.  file must be created in a  certain directory. This must be the  same as
  582.  your FileDoor.CFG  configuration points  to. Various  BBS's handle this
  583.  file  in  a  different  way.  SuperBBS,  which can create FileDoor/DISP
  584.  tag-files, will  place the  tag-file in  the current  directory on each
  585.  and every line you run. Remote Access can use one common directory  for
  586.  all line. You can supply:
  587.  
  588.  - A VALID  directory. RFW will  always put the  BBSTAGFL.x files inside
  589.    this directory (RA flavor);
  590.  
  591.  - You can supply  *CUR in which case  RFW use the CURRENT  directory to
  592. │  put the tag-file in (use this with SBBS);
  593.  
  594.  - You can leave the field empty. In this case RFW wil not use tagging;
  595.  
  596.  ╒══════════════════════════════════════════════════════════════════════════════╕
  597.  │ Do you want scrolling and no clear-screen [Y/N]  : N                         │
  598.  ╘══════════════════════════════════════════════════════════════════════════════╛
  599.  You can choose from either two options:
  600.  
  601.  - The screen  is will clear  before the next  screen is drawn.  This is
  602.    the fastest option and  most SysOp's will use  it I imagine. In  this
  603.    case you supply a 'N';
  604.  
  605.  - The screen is redrawn OVER the current screen. This is the same as  a
  606.    normal DOS application but because  of the low speed (2400  and less)
  607.    this can look a bit messy. In this case you use a 'Y';
  608.  
  609.  'Y'  tends  to  be  somewhat  slower  but  the  result  of  'N' is more
  610.  appealing for the eye when running high-speed modems;
  611.  
  612.  ╒══════════════════════════════════════════════════════════════════════════════╕
  613.  │ Do you want a top-ruler (start of list)   [Y/N]  : Y                         │
  614.  ╘══════════════════════════════════════════════════════════════════════════════╛
  615.  You can choose to display 'TOP OF  LIST' as a ruler. If you don't  want
  616.  this, you must supply 'N';
  617.  
  618.  ╒══════════════════════════════════════════════════════════════════════════════╕
  619.  │ Do you want a bottom-ruler (end of list)  [Y/N]  : Y                         │
  620.  ╘══════════════════════════════════════════════════════════════════════════════╛
  621.  You can choose  to display 'BOTTOM  OF LIST' as  a ruler. If  you don't
  622.  want this, you must supply 'N';
  623.  
  624.  ╒══════════════════════════════════════════════════════════════════════════════╕
  625.  │ Highlight the uploaders name (XFD format) [Y/N]  : Y                         │
  626.  ╘══════════════════════════════════════════════════════════════════════════════╛
  627.  RFW can, optionally,  display the name  of the uploader  in a different
  628.  color. RFW expects comments that  are fully compatible with those  that
  629.  are created by FileDoor <tm> 'uploadername' option. In this case it  is
  630.  also needed that the uploaders name is in the +-comment-line flavor !
  631.  
  632.  If this  options results  in bad  screens or  colors, you  can set this
  633.  option to 'N', otherwise use 'Y'.
  634.  
  635.  ╒══════════════════════════════════════════════════════════════════════════════╕
  636.  │ Only use specified /A for search and new  [Y/N]  : N                         │
  637.  ╘══════════════════════════════════════════════════════════════════════════════╛
  638.  Normally you  only have  to supply  /A when  you use  RFW as a multiple
  639.  choice list ('do  you want to  list, search, list  new files') or  when
  640.  you only want to list files.
  641.  
  642.  If you want the  /A also to work  WITHIN new-files and the  search, you
  643.  must supply a 'Y'. In this case a search will only be conducted in  the
  644.  area you supplied with /A. The same goes for new-files. By default  you
  645.  should use 'N' in this option unless you know what you are doing.
  646.  
  647. │╒══════════════════════════════════════════════════════════════════════════════╕
  648. ││ Enable keyword search INSIDE files        [Y/N]  : Y                         │
  649. │╘══════════════════════════════════════════════════════════════════════════════╛
  650. │When you  have  set  the same option in RFCCFG to 'Y', you can also set
  651. │this  option  to 'Y' overhere. When  enabled in both RFCCFG and RFWCFG,
  652. │the user  can  do  a  keyword search that will also look inside any non
  653. │archived  files (like  text files). The search algorithm for these type
  654. │of searches  is  very fast and will not reduce the overall speed of RFC
  655. │very much, but  all  depends on the actual number of non-archived files
  656. │you have and their combined size.
  657. │
  658. │╒══════════════════════════════════════════════════════════════════════════════╕
  659. ││ Text when in-file keyword matched                : [KEYWORD INSIDE]          │
  660. │╘══════════════════════════════════════════════════════════════════════════════╛
  661. │This  option  can be used to change the default text that RFW  displays
  662. │when an 'inside match' is found.
  663.  
  664.  ╒══════════════════════════════════════════════════════════════════════════════╕
  665.  │ Date format to use (use d/D/m/M/y/Y and sep.char): mm/dd/yy                  │
  666.  ╘══════════════════════════════════════════════════════════════════════════════╛
  667.  You  can  supply  the  date-format  in  the files-list. Any combination
  668.  (within  8  characters  and  using  the  supplied  characters) is valid
  669.  (yy/mm/dd,  mm-dd-yy,  yy:dd:mm  and  so  on).  Be  sure  to  include 8
  670.  characters, otherwise the file-list can be somewhat shifted at  several
  671.  places  (only  when  you  use  multiple  line  comments).   A   capital
  672.  character means  'suppress leading  zero' a  lower-case character means
  673.  'display leading zero'.
  674.  
  675.  ╒══════════════════════════════════════════════════════════════════════════════╕
  676.  │ Priority of memory usage [C/E/X/V/blank] (DOC)  ): CEXV                      │
  677.  ╘══════════════════════════════════════════════════════════════════════════════╛
  678.  This is a tricky one. RFW uses a special array of information that  can
  679.  (must) be stored  virtual. It extends  the normal 64K  bounds in a  way
  680.  that is  similar as  with Windows  3.x <tm>.  RFW will  need to know in
  681.  which priority you would like  to store the information. What  RFW will
  682.  do, is to look in the priority  list you supply over here. If there  is
  683.  room enough  in the  first type  of memory,  it is  used, otherwise the
  684.  second is tried, or the third or the fourth. You MUST at least  specify
  685.  ONE type. Under  normal situations, the  default (CEXV) will  do unless
  686.  you want to  swap priorities (f.i.  XMS before EMS,  thus CXEV) or  you
  687.  have problems with RFW and some type of memory.
  688.  
  689.  Possible values are:
  690.  
  691.  C    : Conventional  memory. With very large databases, this  type will
  692.         almost never be used.  If this is the  case, you can leave  this
  693.         type out, though  the test will  not take much  time and IF  the
  694.         array fits, you get a large gain in speed;
  695.  
  696.  E     : EMS memory.
  697.  
  698.  X     : XMS memory.
  699.  
  700.  V     : Virtual memory (disk!). ALWAYS include at least this type !
  701.  
  702.  blank : Nothing
  703.  
  704.  For example, you want priorities  XMS, EMS and Virtual. You  should set
  705.  the value to XEV. The fourth entry is empty and will not be used.  When
  706.  EMS,  Conventional,  Virtual,  XMS  should  be the priority, you supply
  707.  ECVX.
  708.  
  709.  ╒══════════════════════════════════════════════════════════════════════════════╕
  710.  │ Clear arrays (will cost extra time)       [Y/N]  : N                         │
  711.  ╘══════════════════════════════════════════════════════════════════════════════╛
  712.  This is more or less  a debug option. This option should ONLY BE SET to
  713.  YES is you sometimes have problems with your hard-disk (disk errors) or
  714.  you experience problems  with  RFW (trashed screens, strange files). If
  715.  set to Y, RFW will  first  initialize  the virtual (tmporary) array and
  716.  will then set all array-entries to a value. Normally this is not needed
  717.  because RFW knows  which  array-entries  are  used. When  set to N, RFW
  718.  will still initialize the array but will NOT set all array-entries to a
  719.  value. With large compiled files (+500.000 files), this will reduce the
  720.  waiting (on the user's side) considerable ! Leave it to N  under normal
  721.  conditions.
  722.  
  723.  ╒══════════════════════════════════════════════════════════════════════════════╕
  724.  │ Location virtual array file (empty = current dir):                           │
  725.  ╘══════════════════════════════════════════════════════════════════════════════╛
  726.  If the compiled file gets very large and there are not enough resources
  727.  available (EMS, XMS  or  conventional memory) to store all records, RFW
  728.  will create a virtual  array  on DISK. Normally (if you leave the field
  729.  empty, and for  all  older versions of RFW), the array would be written
  730.  to the current  directory. If this drive is rather small or you want to
  731.  use a faster drive  (ram-disk), you can use this option to point to the
  732.  directory where the  file  should be stored (each RFW on each different
  733.  line will use a unique file-name). Remember that the drive must contain
  734.  around 1 1/2  times  the  space of the RFC.CMP file (compiled file) for
  735.  EACH line you  run  (in  case ALL  lines  use RFW at the same time). In
  736.  those cases where  the  SysOp uses a very large RAM-disk, this disk can
  737.  be used, it it is big enough.
  738.  
  739. │╒══════════════════════════════════════════════════════════════════════════════╕
  740. ││ Calling sequence for viewer (empty = no view)    : C:\SYS\OWN\MTS.EXE /F$F / │
  741. │╘══════════════════════════════════════════════════════════════════════════════╛
  742. │RFW can view files that are  listed. Like 'T' (tagging) you can enter a
  743. │'V' to  view  inside  one or  more files after each other. Because most
  744. │files will be archives, you have to use an archive viewer that can also
  745. │display non-archived  files, like  the DISP <tm> program MTS <tm>. When
  746. │you install a  view-program, you  must  supply the calling sequence for
  747. │this program. In  the calling parameters you can add one or more macros
  748. │that will be expanded by RFW at run-time. These are:
  749. │
  750. │$C : Will be replaced by the actual COM-port
  751. │$B : Will be replaced by the baud-rate
  752. │$T : Will be replaced by the remaining time left for this call;
  753. │$L : Will be replaced by the BBS line number
  754. │$F : Will be replaced by the name of the file that must be viewed
  755. │$M : If set, RFW will  swap  out of  memory before the call to the view
  756. │     program is made (recommended!);
  757. │
  758. │In the  installation version that you obtained from the release archive
  759. │you can already find an example to call DISP <tm> program MTS <tm>.
  760.  
  761.  ╒══════════════════════════════════════════════════════════════════════════════╕
  762.  │ Color for headers    ( low)                      : <TEST>       Blink: N     │
  763.  │ Color for headers    (high)                      : <TEST>       Blink: N     │
  764.  │ Color for header-1                               : <TEST>       Blink: N     │
  765.  │ Color for header-2                               : <TEST>       Blink: N     │
  766.  │ Color for header-3                               : <TEST>       Blink: N     │
  767.  │ Color for header-4                               : <TEST>       Blink: N     │
  768.  │ Color for header-5                               : <TEST>       Blink: N     │
  769. ││ Color for statusline (low)                       : <TEST>       Blink: N     │
  770. ││ Color for statusline (high)                      : <TEST>       Blink: N     │
  771.  │ Color for top-ruler                              : <TEST>       Blink: N     │
  772.  │ Color for bottom-ruler                           : <TEST>       Blink: N     │
  773.  │ Color for art-work/comments                      : <TEST>       Blink: N     │
  774.  │ Color for filename                               : <TEST>       Blink: N     │
  775. ││ Color for pwd.prot. marker                       : <TEST>       Blink: N     │
  776.  │ Color for filesize                               : <TEST>       Blink: N     │
  777. ││ Color for freefile  marker                       : <TEST>       Blink: N     │
  778.  │ Color for filedate                               : <TEST>       Blink: N     │
  779.  │ Color for file-comment                           : <TEST>       Blink: N     │
  780. ││ Color for in-file ks-match                       : <TEST>       Blink: N     │
  781.  │ Color for XFD uploader name                      : <TEST>       Blink: N     │
  782.  │ Color for new files                              : <TEST>       Blink: M     │
  783.  │ Color for error messages                         : <TEST>       Blink: N     │
  784.  │ Color for area-separators                        : <TEST>       Blink: N     │
  785.  │ Color for help-line  ( low)                      : <TEST>       Blink: N     │
  786.  │ Color for help-line  (high)                      : <TEST>       Blink: N     │
  787.  │ Color for tag-option letter                      : <TEST>       Blink: N     │
  788.  │ Color for tagged file char                       : <TEST>       Blink: Y     │
  789.  ╘══════════════════════════════════════════════════════════════════════════════╛
  790.  You can alter  ANY (except the  local information window)  color in the
  791.  list.  For  every  option  you  can  select  one of 128 different color
  792.  combinations. Use N to see the next, P to see the previous and T to  go
  793.  to the first (black) color in the list.  Use ENTER to select the  color
  794.  and then use 'Y' or 'N' to select if you want this field to blink !
  795.  
  796. │The two 'marker' options can result in a complete circus show (for your
  797. │taste). If so, you can use 'black' as the color and they won't be shown
  798. │to the user (they  are  shown, but  black letters on a black background
  799. │are hard to see).
  800.  
  801.  It is NOT possible  (yet) to configure RFW  in a way that  the COMPLETE
  802.  background is reversed. This is  also somewhat slower for the  user and
  803.  thus (also) not a good idea.
  804.  
  805.  
  806.  3.4 BBS menu options
  807.  ────────────────────────────────────────────────────────────────────────
  808.  RFW needs to be installed in a  type 7 (or 15) in the BBS  menu(s). RFW
  809.  needs some command-line options to do its work. These are:
  810.  
  811.  ╒══════════════════════════════════════════════════════════════════════════════╕
  812.  │ /A[area to display]                                                          │
  813.  ╘══════════════════════════════════════════════════════════════════════════════╛
  814.  /A is only needed  with /LF but can  always be supplied (if  this makes
  815.  it more transparent to you). Only  when you select a special option  in
  816.  RFWCFG.EXE,  /A  has  a  meaning  with  all other options than /LF (see
  817.  above). You  must include  the same  path as  you have  supplied in the
  818.  FILES.RA file.  So if  all your  paths are  without a drive-letter, you
  819.  must also leave  the drive-letter out  over here. It  is better to  use
  820.  the standard RA <tm>  option *0 because this  is the same path/area  as
  821.  in FILES.RA. So by default, use /A*0 in your type 7 or 15 menu  record.
  822.  (*0 works only with RA 0.03 and up !).
  823.  
  824.  ╒══════════════════════════════════════════════════════════════════════════════╕
  825.  │ /N[line]                                                                     │
  826.  ╘══════════════════════════════════════════════════════════════════════════════╛
  827.  This option is  important when you  run a multi-line  BBS. Include /N*N
  828.  in your type 7 or  15 if this is the  case. If you forget this  option,
  829.  two concurrent  RFW programs,  could use  the same  EMS/Disk-space when
  830.  they are running,  causing a mess  on the screen  and a hangup  of your
  831.  machine.
  832.  
  833.  ╒══════════════════════════════════════════════════════════════════════════════╕
  834.  │ /LF                               (*) see below                              │
  835.  ╘══════════════════════════════════════════════════════════════════════════════╛
  836.  When you supply this  option, RFW will get  into 'list files' mode  and
  837.  needs a /A  to perform its  task. Only files  in the supplied  area are
  838.  listed.
  839.  
  840.  ╒══════════════════════════════════════════════════════════════════════════════╕
  841.  │ /NF                               (*) see below                              │
  842.  ╘══════════════════════════════════════════════════════════════════════════════╛
  843.  When you supply this option, RFW  will get into 'list new files'  mode.
  844.  You don't have to supply /A, unless in special cases (see RFWCFG.EXE).
  845.  
  846. │╒══════════════════════════════════════════════════════════════════════════════╕
  847. ││ /NFEMSI                           (*) see below                              │
  848. │╘══════════════════════════════════════════════════════════════════════════════╛
  849. │This is the  same  as  /NF but now RFW will not ask for confirmation of
  850. │the  last  scan-date. This  option  can  be uses to replace the RA/SBBS
  851. │internal EMSI  new-file scan. You should need a program like I2FLG100.*
  852. │(created by  Hans Siemons) to  set  and  test  the correct switches and
  853. │flags. With the help  of this program (examples for RA_NEW are included
  854. │but can be  replaced by RFW) and this switch the internal EMSI new-file
  855. │scan can be replaced.
  856. │You don't have to supply /A, unless in special cases (see RFWCFG.EXE).
  857.  
  858.  ╒══════════════════════════════════════════════════════════════════════════════╕
  859.  │ /KS                               (*) see below                              │
  860.  ╘══════════════════════════════════════════════════════════════════════════════╛
  861.  When you  supply this  option, RFW  will get  into 'search for keyword'
  862.  mode. /A is not needed unless in special cases (see RFWCFG.EXE).
  863.  
  864.  ╒══════════════════════════════════════════════════════════════════════════════╕
  865.  │ /FS                               (*) see below                              │
  866.  ╘══════════════════════════════════════════════════════════════════════════════╛
  867.  When  you  supply  this  option,  RFW  will get into 'search for files'
  868.  mode. /A is not needed unless in special cases (see RFWCFG.EXE).
  869.  
  870.  ╒══════════════════════════════════════════════════════════════════════════════╕
  871.  │ /KF                               (*) see below                              │
  872.  ╘══════════════════════════════════════════════════════════════════════════════╛
  873.  When you supply  this option, RFW  will ask a  question to the  user if
  874.  she/he want to go into search-keyword or search-files mode.  /A is  not
  875.  needed unless in special cases (see RFWCFG.EXE).
  876.  
  877.  ╒══════════════════════════════════════════════════════════════════════════════╕
  878.  │ /ASC                                                                         │
  879.  ╘══════════════════════════════════════════════════════════════════════════════╛
  880.  You will force RFW to use ASCII displays when you insert this option !
  881.  
  882.  ╒══════════════════════════════════════════════════════════════════════════════╕
  883.  │ /CFG                                                                         │
  884.  ╘══════════════════════════════════════════════════════════════════════════════╛
  885.  When  /CFG  is  used  on  either  RFC  or RFW, the program will write a
  886.  configuration-file. This file can be  used by RFWCFG and RFCCFG  to add
  887.  the old information to any new release. RFC or RFW will stop after  the
  888.  .CFG file is written;
  889.  
  890.  ╒══════════════════════════════════════════════════════════════════════════════╕
  891.  │ (*) now for something special                                                │
  892.  ╘══════════════════════════════════════════════════════════════════════════════╛
  893.  If you supply neither /LF, /NF, /KF, /KS or /FS, RFW will ask the  user
  894.  what to  do. The  user can  now select  from any  of the option and RFW
  895.  will perform this task. Because the user (at any time in the list)  can
  896.  force RFW  to go  back to  the start  (to ask  a new  mask or  date for
  897.  new-files), this is a powerful  option. You only need one  menu-item to
  898.  do all file (list) access in one strike.
  899.  
  900.  ┌───────┬─────────────────────────────────────────────────────────────┐
  901.  │   4   │ Runtime information                                         │
  902.  └───────┴─────────────────────────────────────────────────────────────┘
  903.  
  904.  4.1 Usage of RFW
  905.  ────────────────────────────────────────────────────────────────────────
  906.  When RFW presents its list of files (if any), after the questions  that
  907.  RFW (optionally)  asks to  the user,  the user  can do  several things.
  908.  FIRST (and most important) is that the user must set his/hers  NUM-LOCK
  909.  to on  (also when  running locally).  If she/he  forgets this,  nothing
  910.  will happen unless 'Q', '?','N','T', [ENTER] or [ESC] is used.
  911.  
  912.  Next the user can use  '7' (simulate of HOME) to  go to the top of  the
  913.  list. '1' (simulate of END) to go to the bottom of the list. These  two
  914.  options can also be used to redraw the screen.
  915.  
  916.  '8' and '2' (simulate CRSR-UP and CRSR-DOWN) can be used to scroll  one
  917.  line up or down at the time.
  918.  
  919.  '9' and '3' (simulate PGUP and PGDN) can be used to scroll one page  at
  920.  up or down at the time.
  921.  
  922.  [ENTER] can also be used as a replacement of '3' (PGDN).
  923.  
  924. │RFW (from version 1.20 and up)  will  also support special key-protocols
  925. │that the remote terminal package can send. These are the protocols that
  926. │are known as the  Maximus, TopEd and QuickEd protocols. When the remote
  927. │package will emulate  the  cursor  keys in one of these modes, RFW will
  928. │correctly interprete them.
  929.  
  930.  [ESC] will terminate the execution.
  931.  
  932.  '?' or 'H' will  force QFW to display  its own help information  or the
  933.  file you supplied with RWFCFG.EXE.
  934.  
  935.  'N' can be used to reset RFW without leaving the program. In all  modes
  936.  except  /LF,  this  option  can  be  used  to  let the user enter a new
  937.  selection (new  search-mask or  new date  for new-files).  If RFW  runs
  938.  without /LF, /NF, /KS,  /FS and /KF, 'N'  will force RFW to  go back to
  939.  the first question to ask the user the mode to run in.
  940.  
  941.  'T' can be used to tag or  un-tag files. When RFW starts, it will  test
  942.  for the presence of  a FileDoor/DISP-compatible tag-file. If  this file
  943.  belongs to the user and  was previously edited by RFW,  the information
  944.  will be displayed to the user and the user can reuse (add/delete  files
  945.  to the list) or delete the tag-file.
  946.  
  947. │'V' can be used to view files. When RFW starts, it will test if you did
  948. │install an  external  viewer  that can use the macros that RFW supports
  949. │(see RFWCFG). When this is  the case, the user is able to view files in
  950. │the same way as she/he can  tag  files. A compatible viewer that can be
  951. │used with RFW is DISP MTS <tm> program.
  952.  
  953.  If RFW was not the last program that edited the tag-file, the user  can
  954.  choose to terminate RFW or to delete the file.
  955.  
  956.  If tagging  is not  set (e.g.  RFW does  not point  to a directory that
  957.  will contain the tag-file), the user is left in peace and no  questions
  958.  are asked.
  959.  
  960.  With  tagging,  the  user  can  tag/un-tag  files from the list. Tagged
  961.  files will be  stored in a  list that can  be used by  FileDoor <tm> or
  962.  other 3th party vendor programs.
  963.  
  964.  At the local  side, you can  also enter any  of the above  keys AND you
  965.  can enter CTRL-T to toggle RFW's information window. If this window  is
  966.  set to ON,  RFW will re-display  this window (only  at the local  side)
  967.  with every change of the screen.  If you toggle this option OFF  again,
  968.  you must wait until  the user changes the  screen before the window  is
  969.  gone again.
  970.  
  971.  The user  is able  to enter  any key  while the  screen is  build. This
  972.  hot-key support looks much like the build-in hot-key support of RA.
  973.  
  974.  RFW monitors the  remaining time the  user is allowed  in the BBS,  the
  975.  carrier (if carrier is lost, RFW  will terminate and the BBS will  take
  976.  over again) and if the user is not entering any key within 2 minutes.
  977.  
  978.  If you want to have current  user information, you must hit the  CTRL-T
  979.  button. This button toggles the status-display !
  980.  
  981.  
  982.  4.2 FileDoor/DISP-compatible tag-file <tm>
  983.  ────────────────────────────────────────────────────────────────────────
  984.  With release   1.10, RFW    contains a   full  FileDoor/DISP-compatible
  985.  tag-file <tm> implementation. What does this mean.
  986.  
  987.  The user  is able  to tag   (or un-tag  for that  matter) files    that
  988.  she/he would like to select  from the list that  RFW presents.  Tagging
  989.  can   be  done  with  the  <T>-key.  A  file   already  tagged  can  be
  990.  un-tagged, a  file that is not tagged can be tagged (so <T> works  like
  991.  a toggle).
  992.  
  993.  When the user terminates  RFW, RFW will write  a special kind of  file.
  994.  This file  is called  the FileDoor/DISP-compatible  tag-file. This file
  995.  has a uniform format  and can be read  by most door-like DISP  programs
  996.  and (its  primary reason  of being  there) by  FileDoor <tm>.  When the
  997.  FileDoor <tm>  program detects  such a  tag-file, it  will test  if the
  998.  file belongs to the current user  (if not, it will be deleted)  and the
  999.  file  will  (or  can)  be  used  as input for the file-selection inside
  1000.  FileDoor  (download/Bidirectional).  RFW  creates  a so called auto-tag
  1001.  file. This means that FileDoor will start reading the tag-file  without
  1002.  asking the user.  The user is  still able though,  to select or  reject
  1003.  the presented choice.
  1004.  
  1005.  When RFW has created  a tag-file and the  user enters RFW again  (while
  1006.  there is still a tag-file from the same user), the user has the  option
  1007.  to reuse the tag-file or to delete it. If the file is reused, RFW  will
  1008.  show all  files already  tagged before  and will  keep files from other
  1009.  areas inside the tag-file. The user can now change the tagging (set  it
  1010.  to off) or add  new files. Before termination,  RFW will merge the  new
  1011.  results in  the old  tag-file. In  this way,  the user  can scroll thru
  1012.  various areas  and can  create a  combined tag-  file that  can be used
  1013.  with FileDoor  (if autosearch  is set  to on).   Deleting the  tag-file
  1014.  means that the old  tag-file is flushed and  (optionally) a new one  is
  1015.  created.
  1016.  
  1017.  When FileDoor <tm>  has used the  RFW tag-file, the  auto-tag switch is
  1018.  set to off.  If the user  enters FileDoor again,  the tag-file must  be
  1019.  selected by hand (/TAG).
  1020.  
  1021.  A description of the  FileDoor/DISP-compatible tag-file is included  in
  1022.  the supporting programs  at the moment  that the internal  structure is
  1023.  released for  public usage.  In this  case a  file called  FDTAGSTR.xxx
  1024.  (where xxx is the version of  the used format, currently 201) is  added
  1025.  to the archive.
  1026.  
  1027.  Programs that  will support  this kind  of tag-file  are, MTS,  RFW and
  1028.  FileDoor itself.  Other products  can choose  to use  the functions  of
  1029.  such a tag-file.
  1030.  
  1031.  
  1032.  4.3 CD-ROM matters
  1033.  ────────────────────────────────────────────────────────────────────────
  1034.  RFC will compile from the BBS-area file and the FILES.BBS files but
  1035.  still needs the actual files because the file-sizes and dates must be
  1036.  obtained somehow. On a CD-ROM drive (with tons of files) this can
  1037.  result in very long waiting times in RFC. RFC 1.20 fixes this problem.
  1038.  The new compiler (RFC.EXE) works as follows:
  1039.  
  1040.  - The first time (when there isn't a previous compiled file or when
  1041.    you run RFC with /ALL), RFC will actually compile ALL areas, also
  1042.    including the CD-ROM areas;
  1043.  
  1044.  - The next time RFC is executed (without /ALL), RFC will first search
  1045.    thru the old database to find the areas that came from a CD-ROM
  1046.    device. These areas are seperated from the old compiled file and
  1047.    put into the temporary directory (not the files but the records
  1048.    from the database, just to make sure);
  1049.  
  1050.  - RFC deletes the old database and starts collecting the information
  1051.    from the area-file and the FILES.BBS files. At the moment it hits
  1052.    a CD-ROM area, it will look to see if there were pervious records
  1053.    from this area. If there were, these records are merged into the
  1054.    new database WITHOUT accessing the CD-ROM at all. If there weren't,
  1055.    RFC will access the CD-ROM and will add the area to the new database;
  1056.  
  1057.  - While merging records, RFC will update the name of the area and the
  1058.    actual security levels and flags, so when you just altered the name
  1059.    of the area (not the location) and/or the security level, RFC will
  1060.    still not access the CD-ROM EVEN when you changed the position of
  1061.    the area in the area-file (f.i. from slot 100 to slot 80);
  1062.  
  1063.  - RFC will merge the records based on the location inside the area-file
  1064.    so they will always be in the correct order;
  1065.  
  1066.  How does RFC deside if an area is a CD-ROM area ? Simple. For RA it
  1067.  will be a CD-ROM area when there is a FILES.x in the alternate files
  1068.  path (see RFCCFG and RACONFIG), for SBBS, it will simply get the info
  1069.  from the FLSEARCH.BBS. All area's that have different directories for
  1070.  the files and the FILES.BBS are marked as CD-ROM areas !
  1071.  
  1072.  If you changed many things in the CD-ROM areas and/or you are not sure
  1073.  about the information inside the RFC-database, you can use a special
  1074.  command-line option for RFC, the /ALL command-line parameter. When you
  1075.  supply /ALL, RFC will recompile all areas without merging old info from
  1076.  previous compiled databases and will obtain all info from the CD-ROM.
  1077.  
  1078.  This information is given to supply you with the most complete info
  1079.  about RFC's CD-ROM handling and can also be used by some other people
  1080.  who are known to copy the best of all other programs to produce a
  1081.  clone of their own (it is a hard world, but it is)....
  1082.  
  1083.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1084.  │   5   │ Version information and credits                             │
  1085.  └───────┴─────────────────────────────────────────────────────────────┘
  1086.  
  1087.  5.1 The BETA-team
  1088.  ───────────────────────────────────────────────────────────────────────
  1089.  Look into the file SUPPORT.MTA for a full list of all beta-testers  and
  1090.  support nodes.
  1091.  
  1092.  
  1093.  
  1094.  5.2 Credits
  1095.  ───────────────────────────────────────────────────────────────────────
  1096.  Thanks  to  the  following  people  (besides  my eternal thanks for the
  1097.  BETA team):
  1098.  
  1099.  - All   paying, registered   users. You   made it   possible to enhance
  1100.    MTA with nice features;
  1101.  
  1102.  - All users who did write me bug reports, suggestions and so on;
  1103.  
  1104.  - Ati Antman  and  Risto Virkkala  for  their support for DISP products
  1105.    and their fine BBS.
  1106.  
  1107.  
  1108.  5.3 Version history
  1109.  ────────────────────────────────────────────────────────────────────────
  1110.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1111.  │  1.01 │ Beta release                                                │
  1112.  └───────┴─────────────────────────────────────────────────────────────┘
  1113.   ■ First non-public beta release;
  1114.  
  1115.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1116.  │  1.02 │ Beta release                                                │
  1117.  └───────┴─────────────────────────────────────────────────────────────┘
  1118.   ■ First public beta release;
  1119.  
  1120.   ■ Changed  the RFC.CMP  into two  files (RFC.CMP  and RFC.ARE) to gain
  1121.     memory;
  1122.  
  1123.   ■ Changed  access  to  RFC.CMP,  thus  creating  a  gain in speed.   A
  1124.     benchmark  with  5000  files  in  FILES.BBS  under DesqView gave the
  1125.     following results:
  1126.  
  1127.     1.01ß2  Stored in memory : 87.56 seconds
  1128.     1.02ß4  Stored on DISK ! : 30.80 seconds
  1129.  
  1130.     A benchmark  with 2000  files in  FILES.BBS under  DesqView gave the
  1131.     following results:
  1132.  
  1133.     1.01ß2  Stored in memory : 37.67 seconds
  1134.     1.02ß4  Stored in memory :  9.61 seconds
  1135.  
  1136.   ■ Fixed some extended ASCII traps,  so ASCII (non ANSI) users can  now
  1137.     look at a clean screen;
  1138.  
  1139.   ■ Fixed name of program in  program header (QFW was displayed and  not
  1140.     RFW).
  1141.  
  1142.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1143.  │  1.03 │ First public release                                        │
  1144.  └───────┴─────────────────────────────────────────────────────────────┘
  1145.  
  1146.   ■ Added Hot-key support
  1147.  
  1148.   ■ RFW is now capable of displaying more than 24 lines if the user  did
  1149.     set a larger number of lines in the user-setup of the BBS;
  1150.  
  1151.   ■ It is  now configurable to  choose between clear-screen/display  and
  1152.     scrollwindow/display;
  1153.  
  1154.   ■ It is now possible to let the 'TOF'/'BOF' rulers out of the list;
  1155.  
  1156.   ■ It is now possible to configure all colors (local and remote);
  1157.  
  1158.   ■ It  is  now  possible  to  configure  the  format the date that  RFW
  1159.     displays in the files-list;
  1160.  
  1161.   ■ You can replace the internal help-screen with your own files.  While
  1162.     displaying this file, Hot-key support is NOT active;
  1163.  
  1164.   ■ It  is now  possible (with  a special  configuration option, to keep
  1165.     downward  compatibility)  to  combine  the  /A option with all other
  1166.     options to reduce the search/display to one area;
  1167.  
  1168.   ■ With keyword/file search any long comment (displayed on a next  line
  1169.     in a normal  file-list) was not  displayed and/or searched.  This is
  1170.     now fixed (in a somewhat cruel way).
  1171.  
  1172.   ■ The user can now force RFW to restart without loading itself again.
  1173.  
  1174.   ■ Fixed some bugs and flaws;
  1175.  
  1176.   ■ Fixed  time-slice  problems  in  DV.  In  combination  with X00  (DV
  1177.     option) there is  no degradation in  performance, even with  8 RFW's
  1178.     concurrent in the machine;
  1179.  
  1180.   ■ Changed  the internal  structure of  the compiled  files again. This
  1181.     gives you a gain  of 3 bytes per  line. You must run  RFC again when
  1182.     upgrading to this version !
  1183.  
  1184.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1185.  │  1.04 │ Bug release                                                 │
  1186.  └───────┴─────────────────────────────────────────────────────────────┘
  1187.  
  1188.   ■ Changed the hotkey-support somewhat. Overrun errors should be  fixed
  1189.     now. Also several hits  on ENTER or PGDN  would result in a  partial
  1190.     displayed screen. This is also fixed;
  1191.  
  1192.   ■ Fixed RFC to work OK on  both the old structure of FILES.RA and  the
  1193.     one introduced with RA 1.00beta8.
  1194.  
  1195.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1196.  │  1.10 │ Minor release                                               │
  1197.  └───────┴─────────────────────────────────────────────────────────────┘
  1198.   ■ Changed the hot-key  support. RFW was know  to eat many ticks.  This
  1199.     was caused by  the special routines  that implemented the  hot-keys.
  1200.     All keys will  now ALWAYS redraw  the screen, so  CRSR-DOWN when the
  1201.     last line is on the screen will still cause a redraw of the  screen.
  1202.     The  same  goes  for  CRSR-UP,  END,  HOME,  PGUP and PGDN. Hot-keys
  1203.     should now work better and with a smaller number of cycles.
  1204.  
  1205.   ■ Added support for QuickBBS and SBBS;
  1206.  
  1207.   ■ Added support for CD-ROM drives in RFC;
  1208.  
  1209.   ■ Added /CFG to RFW and RFC and /ASC to RFW;
  1210.  
  1211.   ■ Added  tag-file support  to create  and use FileDoor/DISP-compatible
  1212.     tag-files;
  1213.  
  1214.   ■ Removed help information from RFW. This is now stored in a  separate
  1215.     help-file (example included);
  1216.  
  1217.   ■ Changed the  FOSSIL-access a bit  and changed the  input-routines to
  1218.     give back more time-slices to DesqView <tm>;
  1219.  
  1220.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1221.  │  1.15 │ Minor and bug-fix release                                   │
  1222.  └───────┴─────────────────────────────────────────────────────────────┘
  1223.   ■ RFC is now configured for  RA 1.1x, QBBS 2.75+ and SBBS  1.16+. This
  1224.     makes a list of 6 different  types of BBS's (and versions) that  can
  1225.     be supported. SBBS does not  need the FLSEARCH.CTL anymore but  will
  1226.     directly support FLSEARCH.BBS. Structures for RA 1.11 and QBBS  2.75
  1227.     and higher are included in RFC(CFG) and RFW(CFG);
  1228.  
  1229.   ■ CD-ROM  should  now  work  ok  (RA  1.0x and RA 1.1x) again.  Please
  1230.     report if this is still a problem;
  1231.  
  1232.   ■ RFC would terminate when FILES.BBS was gone or corrupt. It will now
  1233.     continue with the next area and give a warning;
  1234.  
  1235.   ■ RFC had some strange logic as to what was a file and what should  be
  1236.     a comment  (artwork) in  FILES.BBS. RFW  will now  mark a  line as a
  1237.     file when  a valid  DOS-filename character  is entered  ('*' and '?'
  1238.     are excluded). If  a line starts  with a high-character  or a space,
  1239.     it is seen as artwork, unless a +-comment combination is present;
  1240.  
  1241.   ■ It is now impossible to  tag files which was actually artwork.  This
  1242.     could cause  bugs in  FileDoor <tm>  when a  line with  all '*'  was
  1243.     tagged;
  1244.  
  1245.   ■ RFC will now report errorlevel 255 when aborted due to an error;
  1246.  
  1247.   ■ RFW will not beep anymore when the large array is swapped to EMS,
  1248.     XMS or disk;
  1249.  
  1250.   ■ RFW will not display the type of memory that is in use anymore;
  1251.  
  1252.   ■ RFW would sometimes screw the display (colors). This is now fixed;
  1253.  
  1254.   ■ RFW  could leave  EMS blocks  when the  carrier was  lost before RFW
  1255.     could terminate. Fixed;
  1256.  
  1257.   ■ RFW  would  display  strange  screens  with keyword search. Now  the
  1258.     complete block (file + comments) is displayed correctly;
  1259.  
  1260.   ■ RFW could report error 204  when termination or hang with a  #8/#127
  1261.     combination. Both should be fixed;
  1262.  
  1263.   ■ RFW  would  flash  the  'new-file  marker' when a user selected  new
  1264.     files before the previous log-in. These files are not actually  new,
  1265.     so the new-file  marker is now  only displayed for  actual new files
  1266.     in the new-files list;
  1267.  
  1268.   ■ RFW would look  at the download security  field and not at  the list
  1269.     security (RA). This is fixed;
  1270.  
  1271.   ■ RFW would still allow tagging, even if tagging was switched off. The
  1272.     menus could be trashed while still no tag-file was written. This  is
  1273.     fixed. If tagging is set to off, no tagging  is  possible inside the
  1274.     screens;
  1275.  
  1276.   ■ RFW  screens  about  reusing  tag-files would report 'IGNORE'  where
  1277.     'DELETE' was meant. Fixed;
  1278.  
  1279.   ■ RFW would not allow empty entries while tagging. It is now  possible
  1280.     to 'undo' the tag-option by hitting ENTER;
  1281.  
  1282.   ■ RFW   would allow   empty entries   with 'file-mask'   and 'keyword'
  1283.     but would select EVERYTHING. Now  RFW  will terminate when  an empty
  1284.     line is entered;
  1285.  
  1286.   ■ RFW would expand RFW as  the file-mask to RFW.*. This is  changed so
  1287.     that RFW is expanded to RFW*.*. RFW_V115 is expanded to RFW_V115.*;
  1288.  
  1289.   ■ RFW  would  rebuild  the  screen  when  files were tagged. On  great
  1290.     demand this has been changed. In ANSI mode, RFW will now UPDATE  the
  1291.     correct lines and not redraw the entire screen;
  1292.  
  1293.   ■ RFW  would allow  configured colors  for the  tag-letter and the tag
  1294.     marker. Though you  could specify them  in RFWCFG, RFW  would always
  1295.     force to YELLOW (letter) and LIGHTRED (mark). Fixed;
  1296.  
  1297.   ■ RFW  will now  allow configurable  memory usage  (see RFWCFG.EXE) to
  1298.     store the virtual array of data;
  1299.  
  1300.   ■ RFW would always  point to the same  directory for the tag-file.  In
  1301.     SBBS environments this meant that  you needed two RFW.EXE files.  It
  1302.     is  now  also  possible  to  write  (and search) the tag-file in the
  1303.     current directory (*CUR in RFWCFG);
  1304.  
  1305.   ■ RFW can now  display the name of  the uploader in a  different color
  1306.     when  you  use  the  Filedoor  <tm>  +-comment-line type of uploader
  1307.     information;
  1308.  
  1309.   ■ RFW can now make  use of  the  DISP-compatible  and  4DOS-compatible
  1310.     wildcards (=RFW and *RFW*). This is (obvious) only possible with the
  1311.     find-file option;
  1312.  
  1313.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1314.  │  1.16 │ Minor and bug-fix release                                   │
  1315.  └───────┴─────────────────────────────────────────────────────────────┘
  1316.   ■ RFW can now be  configured to clear (or not clear) the virtual array
  1317.     before  usage. Under  almost  ALL conditions, use the value 'N' (not
  1318.     clear the array) to gain speed;
  1319.  
  1320.   ■ RFW can now be configured  to place the temporary (virtual) array in
  1321.     a directory of  your  own  likes. Normally, RFW would place the file
  1322.     in the CURRENT directory, but now you can choose one of your own;
  1323.  
  1324.   ■ RFW has gained speed  again. This is the main topic for this release.
  1325.     Within a few days, some  angry users called to tell that RFW was too
  1326.     slow for their taste  and  skipped back to 1.10. I have replaced the
  1327.     complete logic for  this  feature and will give some background. The
  1328.     old 1.10 would read 40960  bytes at a time and would 'combine' these
  1329.     bytes to records (a rather tedious routine, but fast). This resulted
  1330.     in the problems with 'keyword search' only being able to display the
  1331.     actual line where  the  keyword was found and not the complete file.
  1332.     1.15 changed the  routines. Now  each  and every record of 111 bytes
  1333.     was read (binary)  and  the 'keyword search' looked much better. The
  1334.     speed was ok on  most  single  tasking machines but on networks, non
  1335.     cached systems  AND  sometimes  in  combination with Desqview/SHARE,
  1336.     the performance dropped  to an abnormal depth. 1.16 has new routines
  1337.     for reading. The  compiled  file  is  opened twice, once as a binary
  1338.     (untyped) file and once as a binary typed file. Now for all routines
  1339.     the untyped mode is  used and chuncks of 590 records at a time (this
  1340.     is almost 64K) are read. Only with keyword search, the typed file is
  1341.     used to read back in the file (ONLY WHEN NEEDED, so ONLY WITH MULTI-
  1342.     COMMENT files). This change  is  benchmarked, giving  the  following
  1343.     results:
  1344.  
  1345.     Compiled file : 64359 files, 7.143.849 bytes in size (HUGE!)
  1346.                     2 areas, area 1 contains 10 files and area 2
  1347.                     contains the remaining 64349 files:
  1348.  
  1349.  
  1350.     RFW 1.15                       List area 2 :  397.48 seconds
  1351.                                    List area 1 :  193.82 seconds
  1352.  
  1353.     RFW 1.16 (clear array)         List area 2 :  290.34 seconds
  1354.                                    List area 1 :  111.59 seconds
  1355.  
  1356.     RFW 1.16 (NOT clear array)     List area 2 :  142.26 seconds
  1357.                                    List area 1 :   26.26 seconds
  1358.  
  1359.  
  1360.     All on a 386/33 without cache and a 35 Ms hard-disk. As you can see,
  1361.     the default 1.16 configuration  (without clear of the array) is some
  1362.     2.7 times faster when a  list of 64349 files must be listed (this is
  1363.     very exeptional, and still  takes  2.5  minutes because of huge disk
  1364.     writes). When you  list  a  small area, the gain in time is some 7.4
  1365.     times faster. In comparison  with  1.10  (there  were fewer tests in
  1366.     1.10, so it is not a completely equal compare), 1.16 is still faster
  1367.     with new-files, filename-search and list and somewhat slower  when a
  1368.     keyword search is performed.
  1369.  
  1370.  ┌───────┬─────────────────────────────────────────────────────────────┐
  1371.  │  1.20 │ Major release                                               │
  1372.  └───────┴─────────────────────────────────────────────────────────────┘
  1373.   ■ Fixed a problem  in RFW where RFW  would beep when the  user dropped
  1374.     the carrier. Caused many nights without good sleep, sorry;
  1375.  
  1376.   ■ Fixed  a problem  in RFWCFG.  The alternate  path setting  would not
  1377.     occur when RA 1.11 was the choosen type of BBS;
  1378.  
  1379.   ■ Fixed a problem  in RFW. 'N' would  not work or would  only work one
  1380.     time. Also memory trashing could occur;
  1381.  
  1382.   ■ Fixed a  problem in RFW.  '?' would trash  the screen when  used and
  1383.     user had to redraw the screen again;
  1384.  
  1385.   ■ Fixed a problem in RFW.  RFW kept one file open, causing  some small
  1386.     problems after running many times after each other;
  1387.  
  1388.   ■ Fixed a number of bad-spots  in RFW which could all trash  memory in
  1389.     some sort  of way.  No reports  of hangups  until now  (at least not
  1390.     hangups that could be traced to RFW);
  1391.  
  1392.   ■ Keyword search would only  display comments up to and  including the
  1393.     line  that  contained  the  match.  This is fixed. All multi-comment
  1394.     lines are now displayed;
  1395.  
  1396.   ■ Fixed ASCII  mode again. Though  many Sysop's are  now talking about
  1397.     swapping to  a full-ANSI  only BBS  right now,  I will still include
  1398.     coding for  those people  who want  to (or  only can)  run in  ASCII
  1399.     mode;
  1400.  
  1401.   ■ Fixed  a  problem  with  the  time-check. RFW would allow  unlimited
  1402.     access (as long the user stayed in RFW). This is fixed;
  1403.  
  1404.   ■ Fixed a  problem with SBBS  CD-ROM entries. Previous  versions would
  1405.     not detect any CD-ROM file;
  1406.  
  1407.   ■ Fixed a problem with  the screen routines for screen-clear  mode. In
  1408.     this mode the lines can be written until the last non-blank byte  to
  1409.     gain speed but RFW was still writing the full 79 characters;
  1410.  
  1411.   ■ Fixed  a problem  where RFC/RFW  could not  find the linking RFC.ARE
  1412.     file if you changed the name of this file in either RFC or RFW;
  1413.  
  1414.   ■ Fixed a problem  with RFCCFG. It is  now allowed to leave  the field
  1415.     for the alternate FILES.BBS files empty;
  1416.  
  1417.   ■ Fixed  a problem  with RFW  where RFW  would create  a tag-file that
  1418.     would drive FileDoor <tm> wild;
  1419.  
  1420.   ■ Fixed a problem with RFW where [foobar] (not a counter) would  cause
  1421.     wrong adjustments in the display;
  1422.  
  1423.   ■ Fixed  a problem  with RFWCFG  and RFCCFG.  These programs  will now
  1424.     keep  the  original  date/time  and  archive-bit when they patch RFW
  1425.     and/or RFC;
  1426.  
  1427.   ■ New-files scan would allow dates in the future, this is fixed;
  1428.  
  1429.   ■ RFWCFG would only display the right color and not the name. To  help
  1430.     people with monochrome  tubes or disabled  people (those people  who
  1431.     can  not  see  any  colors),  the  name  of  the actual color is now
  1432.     displayed;
  1433.  
  1434.   ■ Added options to allow both alternate date or number of days when  a
  1435.     new-file scan is  entered and the  user does not  want to scan  from
  1436.     from the default date;
  1437.  
  1438.   ■ Added option to allow ESC while RFW is searching thru the  database.
  1439.     In this case RFW is aborted;
  1440.  
  1441.   ■ Added a  statusbar at the  bottom of the  local screen so  the sysop
  1442.     can now always see who is  using RFW and in what mode  (the previous
  1443.     versions included a ALT-T mode, which is now obsolete);
  1444.  
  1445.   ■ Added a progress-bar  so the user can  see that RFW is  searching in
  1446.     the database;
  1447.  
  1448.   ■ Added options in RFC and RFW to allow the user to scan for  keywords
  1449.     INSIDE non-archived files;
  1450.  
  1451.   ■ Added option in  RFW to allow the  <V>iew of one or  more files. RFW
  1452.     will call  the specified  viewing program.  MTS <tm>  will suit your
  1453.     needs in  this matter  as it  can view  both archived  files and non
  1454.     archived files;
  1455.  
  1456.   ■ Changed the  <N>ew option into  <R>escan because it  could confuse a
  1457.     user. The user  would think that  this option would  display the new
  1458.     files. The old 'N' key is still allowed though;
  1459.  
  1460.   ■ Changed  the location  of the  tag-marker. This  marker (a '*') will
  1461.     now  be  displayed  behind  the  tag-letter and before the filename.
  1462.     The previous versions would write the tag-marker behind the name  of
  1463.     the file. This change was  needed to allow the 'P'  (protected file)
  1464.     to be displayed behind the filename;
  1465.  
  1466.   ■ Changed the  recompile logic. CD-ROM  areas have to  be scanned only
  1467.     once  and  will  be  merged  into  the  database at the next compile
  1468.     without having to access the  CD-ROM itself. The SysOp can  overrule
  1469.     this logic by using /ALL on the RFC command-line;
  1470.  
  1471.   ■ Changed the memory  logic for the virtual  array that RFW uses.  The
  1472.     previous versions would assign a virtual array with a size equal  to
  1473.     the total number of records  in all areas. The current  version will
  1474.     only use  the actual  number of  records for  a specific  area.  The
  1475.     logic is  only changed  for the  file-list function  and not for the
  1476.     keyword/file-search options and  new-file scan. It  can result in  a
  1477.     dramatical gain in speed and reduced memory consumption;
  1478.  
  1479.   ■ Added options to  allow RFW to display  markers when files are  free
  1480.     files  and/or  password  protected  files.  You  have to assign your
  1481.     FILES.CTL in RFCCFG.EXE to let this option work;
  1482.  
  1483.   ■ Added  the  /NFEMSI  option  to  RFW  to  allow  RFW to replace  any
  1484.     internal EMSI new-file scan  (with the help of  a flag-test/flas-set
  1485.     program like I2FLG100.* by Hans Siemons);
  1486.  
  1487.   ■ Added TopEd,  QuickEd and Maximus  cursor-key protocols to  RFW. RFW
  1488.     will interprete these cursor-empulations in the same way as you  use
  1489.     the numeric pad;
  1490.  
  1491.   ■ Added configurable counter starting/ending characters. Though  these
  1492.     are mainly for  our Scandinavian friends,  they could come  in handy
  1493.     when you don't use '[' and ']' as these characters;
  1494.  
  1495.   ■ Added some logic to support the upcomming RA 1.20 release;
  1496.  
  1497.   ■ Added   logic   for    Commercial,   Closed-BBS   and   beta-testing
  1498.     registration keys;
  1499.  
  1500.   ■ Recompiled all  programs under Borland  Pascal 7.0 (real  mode only,
  1501.     on request a DPMI version can be created), which should result in  a
  1502.     gain in speed;
  1503.  
  1504.  
  1505.  
  1506.  5.4 Copyright, Trademarks
  1507.  ────────────────────────────────────────────────────────────────────────
  1508.  CRA           is a trademark of DISP and donated to public domain
  1509.  DesqView      is a trademark of Quarterdeck inc.
  1510.  Windows       is a trademark of The Microsoft Corporation
  1511.  4Dos          is a trademark of J.P. Software / R.C. Conn and T. Rawson
  1512.  FrontDoor     is a trademark of J. Homrichhausen
  1513.  QuickBBS      is a trademark of Pegasus Software
  1514.  SuperBBS      is a trademark of the SuperBBS group, Aki Antman and
  1515.                                  Risto Virkkala
  1516.  Remote Access is a trademark of Continental Software
  1517.  X00           is a trademark of Ray Gwinn
  1518.  MTA           is a trademark of Robert W. van Hoeven / DISP
  1519.  MTS           is a trademark of Robert W. van Hoeven / DISP
  1520.  Filedoor      is a trademark of Robert W. van Hoeven / DISP
  1521.  
  1522.  RFW is written in Borland Pascal  7.0, with help of the Turbo  Debugger
  1523.  3.5 and  makes extensive  use of  Object Professional  1.20. Also OPCFI
  1524.  version 16.05  is included.  Sub-development and  special projects  for
  1525.  286/386-only  environments  is  done  with  the  marvelous   StonyBrook
  1526.  Pascal+ compiler version 6.14e.
  1527.  
  1528.  Pascal+             is a trademark of Stony Brook Software
  1529.  Borland Pascal      is a trademark of Borland International
  1530.  Turbo Debugger      is a trademark of Borland International
  1531.  Object Professional is a trademark of TurboPower Inc.
  1532.  OPCFI and CFI       is a trademark of Robert W. van Hoeven
  1533.  
  1534.  ========================= END OF DOCUMENT =============================
  1535.